home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / utilties / diskl264 / newstuff.264 < prev    next >
Text File  |  1992-11-05  |  16KB  |  414 lines
  1.  
  2.  
  3.  
  4.                              DISKLIST Version 2.64
  5.  
  6.        This file contains the list and documentation for new features in
  7.        DISKLIST since Version 2.50 - these are not in the DISKLIST
  8.        manual that is in the file DISKLIST.DOC.  Please read
  9.        DISKLIST.DOC, and, if you are using a laser or ink jet printer,
  10.        also read DISKLASR.DOC.
  11.  
  12.        The major new features since Version 2.50 are:
  13.  
  14.           1) DISKLIST can now create a Disk Catalog,
  15.           2) List only the files in a specific subdirectory,
  16.           3) The ability to run DISKLIST without any display, unless
  17.              DISKLIST has to report an error.  Consequently, it can also
  18.              be run from a batch file.
  19.           4) Finely adjust the left margin when printing on Avery labels.
  20.           5) Set the last drive letter - allows DISKLIST to run on a LAN.
  21.           6) Automatically read a title line from a disk.
  22.           7) Print multiple lines of text from a file onto the list.
  23.           8) Deselect any DISKLIST data including file directory data.
  24.           9) A new output device option is Ink Jet Printer.
  25.  
  26.        These are explained in more detail in NEW FEATURE DESCRIPTION below.
  27.  
  28.  
  29.        BUG FIXES
  30.  
  31.        DISKLIST will now run from subdirectories that have a very long
  32.        path name.  Previous versions of DISKLIST won't run under this
  33.        condition.  It blew up when it tried to find the file
  34.        DISKLIST.PRM in the subdirectory with the long name.
  35.  
  36.        DISKLIST now reports the actual drive size on partitions larger
  37.        than 67 megs.  Before it would give a number like -57 million for
  38.        the space on large drives.
  39.  
  40.        DISKLIST now handles error code 24 generated by some printers and
  41.        does not abend.
  42.  
  43.  
  44.        EDITORIAL CHANGE
  45.  
  46.        A few of the original DISKLIST format titles have changed to be
  47.        consistent with the titles of formats added later, but all
  48.        formats are the same since Ver 2.50.  For example, 'NORMAL' is
  49.        changed to '1 with All' to indicate 1 column on the list
  50.        containing all data fields - Name, Size, Date, Time.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                       -1- 
  60.  
  61.  
  62.  
  63.        NEW FEATURE DESCRIPTION
  64.  
  65.  
  66.        1.  DISK CATALOG
  67.  
  68.        DISKLIST can produce a single catalog file of the files that are
  69.        on many disks.  The purpose is for you to be able to search a
  70.        list to determine which disk a particular file is on.  It is
  71.        intended to be used for disks that contain data files.
  72.  
  73.        First check to make sure each disk has a label name.  Use the DOS
  74.        command DIR or LABEL to display the label name.  If you want to
  75.        add or change a label, use the DOS command LABEL.
  76.  
  77.                            LABEL A:
  78.  
  79.        If you don't want to delete or change the existing label, press
  80.        return when DOS prompts for a new label or none.  DOS will then
  81.        ask if you want to delete the existing label.  The label name can
  82.        be 11 characters and have imbedded spaces.  Don't use a period
  83.        like you do in a file name or DOS will say the name is invalid.
  84.        Also write the label name on the disk with a felt tip pen so you
  85.        can identify the disk later.
  86.  
  87.        Run DISKLIST to create the catalog file.  For Parameter 5 in the
  88.        control window, Output Device, select Disk & Vol Name.  This
  89.        feature is similar to the output device File with two exceptions.
  90.        Only file names, space, date, and time are written to the file,
  91.        not any titles or directory names.  And, the disk volume label
  92.        name is written on each line before the file name.
  93.  
  94.        To make use of this feature, run DISKLIST on a series of disks
  95.        and send the output to the same catalog file.  DISKLIST will
  96.        append data to a previously used catalog file.
  97.  
  98.        You can add a comment about each file name in the catalog file
  99.        that DISKLIST produced.  Use an ASCII word processor such as
  100.        PC-Write or DOS 5 EDIT.  Start the comment after the file time
  101.        data.  Then sort the file on the file name with the DOS sort
  102.        command using the following syntax:
  103.  
  104.             SORT /+15 < input file name > output file name
  105.  
  106.        The symbols < and > are part of the command and you must put them
  107.        in.  The input file name is the file DISKLIST wrote all the data
  108.        to.  The output file can have the same name or any other name.
  109.        For example, if your catalog file is named CATFILE, then the sort
  110.        command would be:
  111.  
  112.             SORT /+15 < CATFILE > CATFILE
  113.  
  114.        You can sort on the comments you inserted with the command:
  115.  
  116.  
  117.  
  118.                                       -2- 
  119.  
  120.  
  121.  
  122.             SORT /+58 < input file name > output file name
  123.  
  124.        The switches /+15 and /+58 specify the column that SORT starts
  125.        sorting on.  To find out more about sort in DOS 5 use the
  126.        command:
  127.  
  128.                         SORT /?
  129.  
  130.        Now you can print the catalog file to visually scan to find out
  131.        what disk a particular file is on, or search the catalog file
  132.        using a word processor or LIST or Q-DOS 3.
  133.  
  134.  
  135.        2.  SUBDIRECTORY LIST
  136.  
  137.        DISKLIST can now limit the list to the files in a single
  138.        directory or directory tree.  Below is the new control window.
  139.        Parameter 3 now contains the functions of the old parameter 3 &
  140.        4.  Parameter 4 defines the directory you want to list.  If the
  141.        directory name is longer than the display area, the name is
  142.        truncated for the display but the full name is used.
  143.  
  144.        On the same line as Directory is the command B to toggle Yes or
  145.        No your desire to also list the subdirectories of the directory
  146.        you selected.
  147.  
  148.  
  149.               Parameters         D I S K L I S T         Commands
  150.        ═══════════════════════════════════════════════════════════════════
  151.        1 - Disk Drive       C:               H or F1 - HELP  A - Space Yes
  152.        2 - Filespec         *.*              P - Print List  Z - ZIP   No
  153.        3 - Sort Files by    Name Ascending   L - Line Feed   E - Eject Page
  154.        4 - Directory        \PROCOMM\FILES   B - Subdirs Yes T - LPT1:
  155.        5 - Output Device    Laser Printer    S - Save Title on Disk Drive
  156.        6 - Format           5¼ 1 with All    R - Read Title from Disk Drive
  157.        7 - Border Line Type IBM    ├───┤     F - Print Registration Form
  158.        8 - Lines Per List   28               C - Configuration
  159.        9 - Title for List                    F10 or ESC - Quit DISKLIST
  160.  
  161.  
  162.  
  163.        3.  BATCH OPERATION
  164.  
  165.        DISKLIST Command Line Syntax for automatic operation
  166.  
  167.        DISKLIST can be run from the command line or a batch file without
  168.        any display.  It will print one list then exit.  Only /AUTO is
  169.        required.  The format of the command line is:
  170.  
  171.        DISKLIST   drive  /AUTO, filespec, directory, list subdirectories?,
  172.        type sort, sort direction, output device, format, printer port,
  173.        read title from disk
  174.  
  175.  
  176.  
  177.                                       -3- 
  178.  
  179.  
  180.  
  181.        drive           the drive letter of the diskette to be read, optional
  182.        /AUTO           tells DISKLIST to perform an automatic operation
  183.        filespec        file selection template, i.e. *.*
  184.        directory       directory name
  185.        list subdirectories?       0 = Yes, 1 = No
  186.        Type Sort       Enter a digit for the type sort desired:
  187.                        1 = Name, 2 = .EXT, 3 = Date, 4 = Size, 5 = No sort
  188.        Sort Direction  0 = Ascending, 1 = Descending
  189.        Output Device   0 = NonLaser printer, 1 = Screen, 2 = Disk,
  190.                        3 = Laser Printer, 4 = Avery-Laser
  191.                        5 = Sleeve on LJ 3, 6 = Catalog file
  192.        Format          1 to 36 as numbered in DISKLIST with F7
  193.        Printer Port    Enter LPT #, i.e. 1, 2 or 3.  Enter digit only
  194.        Read Title      Y = read, N = not to read, the title for list from
  195.                        DISKLIST.TTL on the selected drive
  196.  
  197.        All of these parameters are optional except /AUTO.  DISKLIST will
  198.        use the values you used last that are saved in the file
  199.        DISKLIST.PRM unless you override then on the command line.  If
  200.        you do want to override a selection, you must insert all of the
  201.        commas before the value so DISKLIST knows which parameter you are
  202.        changing.
  203.  
  204.        For example, if the only change for this run to parameters saved
  205.        in the DISKLIST.PRM file is that you want to sort by size instead
  206.        of by the selection saved in DISKLIST.PRM, then enter this
  207.        command:
  208.  
  209.                      DISKLIST /AUTO,,,,4
  210.  
  211.        The last three of the four commas indicate that you accept the
  212.        values in DISKLIST.PRM for filespec, directory, and list
  213.        subdirectories?.  And since there are no entries after the 4 (for
  214.        Size), you also accept all the other parameters in DISKLIST.PRM.
  215.  
  216.        DISKLIST.PRM is not changed after a /AUTO run.
  217.  
  218.        There is a file on the distribution disk named AUTOLIST.BAT.  You
  219.        can edit it with a text editor to insert the values you desire in
  220.        the line that starts with DISKLIST.  Rem stands for REMARK and
  221.        tells DOS to ignore that line.  The comments on the rem lines are
  222.        there to help you figure out what parameters to put where.  Leave
  223.        all the rem lines in, and execute the bat file just by entering
  224.        its name, AUTOLIST, at a DOS prompt.
  225.  
  226.        You may also run DISKLIST /? which produces a help screen.  The
  227.        file DISKLIST.HLP must be in the same directory as DISKLIST.EXE.
  228.  
  229.  
  230.        4.  ADJUST AVERY LABELS
  231.  
  232.        On some laser printers the list doesn't quite align with the
  233.        Avery labels and a character or two may not print on the label.
  234.  
  235.  
  236.                                       -4- 
  237.  
  238.  
  239.  
  240.        You may adjust the left margin where DISKLIST starts printing the
  241.        Avery label.
  242.  
  243.        Select Configuration from the control window.  Then select item D
  244.        from the Configuration menu.  You are prompted to enter values
  245.        that will reposition the printing of the lists by 720ths of an
  246.        inch for each column of both 3½ and 5¼ labels.  The values can be
  247.        positive or negative.  Negative values adjusts to the left.
  248.  
  249.        An adjustment of the left margin of one label column does not
  250.        affect the position of the other label columns.  Each column is
  251.        adjusted individually.  These values are saved by DISKLIST.  When
  252.        prompted for new values, enter a new value or press RETURN to
  253.        accept the value in the brackets.
  254.  
  255.        For example, DISKLIST prints about 17 characters per inch on most
  256.        Avery Labels.  So to shift the left margin to the right by one
  257.        character, the value entered would be 42 (= 720/17).  You can see
  258.        that you have very fine control of the position of the left
  259.        margin.
  260.  
  261.  
  262.        5.  SET THE LAST DRIVE LETTER
  263.  
  264.        (This feature is also useful even if you do not access a LAN, so
  265.        all should read it).
  266.  
  267.        When DISKLIST starts, it checks to determine the last physical
  268.        drive in your computer and limits your drive selection to this
  269.        value.  LAN users have additional drive letters that previous
  270.        versions of DISKLIST could not read.
  271.  
  272.        To set the last drive letter in DISKLIST, select Configuration
  273.        from the control window.  Then select item E from the
  274.        Configuration menu.  A question mark indicating a prompt appears
  275.        at the end of the menu line:
  276.  
  277.                  Last Drive for LAN use?
  278.  
  279.        Enter the highest drive letter you expect to use.  It doesn't
  280.        hurt to enter Z.  If you try to have DISKLIST read a drive that
  281.        it can not, it presents an error message.
  282.  
  283.        If you have selected a last drive letter and want DISKLIST to
  284.        return to automatic detection of the last drive, press return at
  285.        this prompt.
  286.  
  287.        This feature can also be used if you only want DISKLIST to select
  288.        drives A and B.  Set the last drive letter to B.
  289.  
  290.        6.  DISKLIST has had the ability to print a single line title
  291.        that can be saved on the disk in a file named DISKLIST.TTL.  The
  292.        title and file can be created from DISKLIST.  DISKLIST contains a
  293.  
  294.  
  295.                                       -5- 
  296.  
  297.  
  298.  
  299.        command to read the title from the file.  Ver 2.64 contains the
  300.        option of having DISKLIST automatically read the title that is on
  301.        a disk when a list is printed.
  302.  
  303.        Toggle this option on and off in the configuration screen.  It
  304.        is item F, Auto Read Title from Disk.  Like all configuration
  305.        settings, your choice is saved when you exit DISKLIST.
  306.  
  307.        If you are running DISKLIST with the /AUTO switch as described
  308.        above and the default setting in your parameter is to read the
  309.        title from the disk, you can overide it using N for the parameter
  310.        to read the title from the disk.
  311.  
  312.        7.  In addition to the one line title, DISKLIST now allows a
  313.        multiple line message to be printed at the top of the list.  It
  314.        is printed below the title and disk volume name, although both of
  315.        these can be deselected from the configuration screen.
  316.  
  317.        Put your message in an ASCII file.  Name that file DISKLIST.HDR.
  318.        If DISKLIST.HDR is in the root directory of a disk, DISKLIST will
  319.        print it as is, whereas DISKLIST centers the title on the list.
  320.        Actually it is possible to use DISKLIST to just print this
  321.        message by deselecting everything else.
  322.  
  323.        8.  Configuration Screen Additions.  Use the configuration screen
  324.        to toggle the data elements that DISKLIST prints about the disk
  325.        on and off.  Press C when in the control window to activate the
  326.        configuration screen.  Read the configuration list carefully.
  327.        The purpose of the configuration screen is to give you control
  328.        over the layout of the list.  New options are always being added.
  329.        A few of the new ones will be mentioned here.
  330.  
  331.        You can turn off the printing of the file names.  And, registered
  332.        users may disable printing Created by DISKLIST.
  333.  
  334.        Another new option on the configuration screen is to Print Root
  335.        Directory Name - Yes/No.  Benefit - one less line on the list if
  336.        you are trying to print many file names on an Avery label.
  337.  
  338.        9.  DISKLIST now has Ink Jet Printer as a new Output Device
  339.        option.  The output device Ink Jet Printer works exactly the same
  340.        as Laser Printer because the ink jet uses the same HP commands and
  341.        command data file, DISKLIST.LSR.  The Ink Jet Printer option is
  342.        there so that ink jet users know what output device to use without
  343.        reading the manual.  Ink jet users please read the section of the
  344.        DISKLIST manual, DISKLIST.DOC, on the Deskjet - it contains some
  345.        very important ink jet setup information.
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                       -6- 
  355.  
  356.  
  357.  
  358.                             Configuration Menu
  359.  
  360.                       1 - NonLaser Printer Codes    F5
  361.                       2 - Laser Commands            F6
  362.                       3 - Form/Printer Sizes        F7
  363.                       4 - Date Format         MM/DD/YY
  364.                       5 - Download a Font           F3
  365.                       6 - Print Total Space at TOP  Yes
  366.                       7 - Print Date-Time at TOP    No
  367.                       8 - Print Date-Time at BOTTOM Yes
  368.                       9 - Lines to skip at label gap 0
  369.                       A - Line under Title & Label  No
  370.                       B - A Blank Line at the Top   No
  371.                       C - Print File Names          Yes
  372.                       D - Position Avery Labels
  373.                       E - Last Drive for LAN use
  374.                       F - Auto Read Title from Disk Yes
  375.                       G - Print Root Directory Name Yes
  376.                       H - Print Header File         Yes
  377.                       I - Print Volume Name         Yes
  378.                       J - Print Created by DISKLIST Yes
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                       -7- 
  414.